Detalle de Compliance
Este endpoint entrega el reporte completo de Compliance de un RUT cargado en tu cuenta, sea de una persona natural o jurídica: sociedades relacionadas, listas internacionales, antecedentes penales, noticias, Personas Expuestas Políticamente (PEP), familiares de PEP y funcionarios públicos. Si el RUT tiene análisis Marshal, el reporte incluye también sus hallazgos.
- Consultar un RUT ya cargado en tu cuenta no genera costos adicionales.
- El RUT debe estar cargado en tu cuenta antes de la consulta (ver Carga de RUT).
- Requiere que tu plan incluya el ayudante Compliance.
- Las coincidencias se buscan en las fuentes al momento de la consulta.
- La respuesta depende de si el RUT corresponde a una persona jurídica o a una persona natural.
- Se agrega
marshal.detectadoenpepChileyfamiliaresPep, y los hallazgos de Marshal aparecen ennoticias. periodose entrega en formatoDD-MM-YYYYcuando es una fecha exacta, y ennullcuando la fuente no lo informa.tipoPersonausa"juridica"en lugar de"juridical".
Ver la Guía de Migración.
Detalle de API
Request
- URL:
/helper/compliance/{rut} - Método:
GET
Parámetros de ruta (path)
| Valor | Tipo | Es requerido | Descripción |
|---|---|---|---|
rut | string | Sí | RUT a consultar, en formato 12345678-9. |
Ejemplo request con curl
curl -X 'GET' \
'https://prod.api.thesheriff.cl/api/clients/v3/helper/compliance/76123456-0' \
-H 'accept: application/json' \
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9EjemploDeToken123'
Response
| Campo | Tipo | Descripción |
|---|---|---|
success | bool | Indica si la operación fue exitosa. |
data | object | Reporte completo de Compliance del RUT consultado. |
Diferencias por tipo de persona
El campo tipoPersona indica si el RUT corresponde a una persona jurídica ("juridica") o a una persona natural ("natural"). Ambos tipos devuelven las mismas keys, pero con distinto contenido:
| Campo | Persona jurídica | Persona natural |
|---|---|---|
tipoPersona | "juridica" | "natural" |
nombre | Razón social | Nombre completo de la persona |
sociedades.coincidencias | Una fila: la sociedad consultada, con nombreSocio, rutSocio y fuente en null | Una fila por cada sociedad en la que participa la persona, con sus datos en nombreSocio y rutSocio |
pepChile, familiaresPep, funcionariosPublicos | Sin coincidencias: las búsquedas de PEP, familiares de PEP y funcionarios públicos no se hacen para personas jurídicas. marshal.detectado se informa igual | Coincidencias encontradas |
Respuesta para persona jurídica
Success
-
Status code: 200
-
Example response body:
{
"success": true,
"data": {
"rut": "76123456-0",
"estado": "PROCESADO",
"tipoPersona": "juridica",
"nombre": "EMPRESA FICTICIA SPA",
"riesgo": "critical",
"sociedades": {
"coincidencias": [
{
"nombreSociedad": "EMPRESA FICTICIA SPA",
"rutSociedad": "76123456-0",
"nombreSocio": null,
"rutSocio": null,
"fecha": "2021-06-02",
"socios": [
{
"nombre": "SOCIO FICTICIO UNO",
"rut": "11111111-1",
"domicilio": "CALLE EJEMPLO 123, LAS CONDES",
"tipoDeParticipacion": "Administrador - Socio",
"cargo": null,
"porcentajeParticipacion": "70"
}
],
"extractos": [
{
"actuacion": "CONSTITUCION",
"fecha": "2021-06-02",
"url": "https://www.diariooficial.interior.gob.cl/publicaciones/2021/06/02/"
}
],
"participaciones": [
{
"razonSocial": "FILIAL FICTICIA SPA",
"nombre": "FILIAL FICTICIA SPA",
"rut": "33333333-3",
"tipoPersona": "juridica",
"tipoDeParticipacion": "SOCIO",
"cargo": null,
"porcentajeParticipacion": "50",
"domicilio": null,
"vigente": true
}
],
"fuente": null
}
],
"totalCoincidencias": 1
},
"listasInternacionales": {
"coincidencias": [
{
"nombre": "EMPRESA FICTICIA SPA",
"lista": "OFAC - Office of Foreign Assets Control",
"url": "https://sanctionssearch.ofac.treas.gov/"
}
],
"totalCoincidencias": 1
},
"penal": {
"coincidencias": [],
"totalCoincidencias": 0
},
"noticias": {
"coincidencias": [
{
"nombre": "EMPRESA FICTICIA SPA",
"titulo": "Formalizan a gerente de Empresa Ficticia SpA",
"fuente": "df.cl",
"url": "https://www.df.cl/noticia-ficticia",
"urlFuente": "https://df.cl",
"tema": ["Riesgo Financiero"],
"periodo": "14-08-2026"
},
{
"nombre": "EMPRESA FICTICIA SPA",
"titulo": "Multa de la CMF a Empresa Ficticia",
"fuente": "La Tercera",
"url": "https://www.latercera.com/noticia-ficticia",
"urlFuente": "https://www.latercera.com",
"tema": ["multas"],
"periodo": "16-01-2025"
}
],
"totalCoincidencias": 2
},
"pepChile": {
"coincidencias": [],
"totalCoincidencias": 0,
"marshal": {
"detectado": false
}
},
"familiaresPep": {
"coincidencias": [],
"totalCoincidencias": 0,
"marshal": {
"detectado": false
}
},
"funcionariosPublicos": {
"coincidencias": [],
"totalCoincidencias": 0
}
}
}
Campos dentro de data (persona jurídica):
| Campo | Tipo | Puede ser null | Descripción |
|---|---|---|---|
rut | string | No | RUT consultado (formato 12345678-9). |
estado | string | No | "PROCESADO" o "NO PROCESADO" (ver Sin búsqueda posible). |
tipoPersona | string | No | Siempre "juridica". |
nombre | string | No | Razón social usada en la búsqueda; "" si no hay. |
riesgo | string | No | Riesgo agregado del perfil: "free", "medium" o "critical". |
sociedades | object | No | La sociedad consultada (ver tabla siguiente). |
listasInternacionales | object | No | Coincidencias en listas internacionales y total. |
penal | object | No | Coincidencias de antecedentes penales y total. |
noticias | object | No | Coincidencias de noticias, incluidos los hallazgos de Marshal, y total. |
pepChile | object | No | coincidencias: [] y totalCoincidencias: 0: la búsqueda de PEP no se hace para personas jurídicas. marshal.detectado puede ser true si Marshal detectó un PEP (ver Marshal). |
familiaresPep | object | No | coincidencias: [] y totalCoincidencias: 0: la búsqueda de familiares de PEP no se hace para personas jurídicas. marshal.detectado puede ser true si Marshal detectó una relación con un PEP. |
funcionariosPublicos | object | No | coincidencias: [] y totalCoincidencias: 0: la búsqueda de funcionarios públicos no se hace para personas jurídicas. |
sociedades.coincidencias[] (persona jurídica): un único elemento con la sociedad consultada.
| Campo | Tipo | Puede ser null | Descripción |
|---|---|---|---|
nombreSociedad | string | Sí | Razón social de la sociedad consultada. |
rutSociedad | string | Sí | RUT de la sociedad consultada. |
nombreSocio | string | Siempre | No aplica a personas jurídicas. |
rutSocio | string | Siempre | No aplica a personas jurídicas. |
fecha | string | Sí | Fecha de constitución de la sociedad (formato YYYY-MM-DD). |
socios | array | No | Socios de la sociedad (ver Estructuras comunes). |
extractos | array | No | Extractos o publicaciones de la sociedad. |
participaciones | array | Sí | Sociedades en las que la sociedad consultada participa. |
fuente | string | Siempre | No aplica: la sociedad consultada no llega por una relación. |
Respuesta para persona natural
Success
-
Status code: 200
-
Example response body:
{
"success": true,
"data": {
"rut": "11111111-1",
"estado": "PROCESADO",
"tipoPersona": "natural",
"nombre": "JUAN PEREZ SOTO",
"riesgo": "critical",
"sociedades": {
"coincidencias": [
{
"nombreSociedad": "EMPRESA FICTICIA SPA",
"rutSociedad": "76123456-0",
"nombreSocio": "JUAN PEREZ SOTO",
"rutSocio": "11111111-1",
"fecha": "2021-06-02",
"socios": [
{
"nombre": "JUAN PEREZ SOTO",
"rut": "11111111-1",
"domicilio": "CALLE EJEMPLO 123, LAS CONDES",
"tipoDeParticipacion": "Administrador - Socio",
"cargo": null,
"porcentajeParticipacion": "70"
}
],
"extractos": [
{
"actuacion": "CONSTITUCION",
"fecha": "2021-06-02",
"url": "https://www.diariooficial.interior.gob.cl/publicaciones/2021/06/02/"
}
],
"participaciones": [],
"fuente": "Empresa en un Día"
},
{
"nombreSociedad": "INVERSIONES FICTICIAS LIMITADA",
"rutSociedad": "77777777-7",
"nombreSocio": "JUAN PEREZ SOTO",
"rutSocio": "11111111-1",
"fecha": "2015-03-10",
"socios": [
{
"nombre": "JUAN PEREZ SOTO",
"rut": "11111111-1",
"domicilio": null,
"tipoDeParticipacion": "Socio",
"cargo": null,
"porcentajeParticipacion": "40"
}
],
"extractos": [],
"participaciones": [],
"fuente": "Diario Oficial"
}
],
"totalCoincidencias": 2
},
"listasInternacionales": {
"coincidencias": [],
"totalCoincidencias": 0
},
"penal": {
"coincidencias": [
{
"nombre": "JUAN PEREZ SOTO",
"postura": "Querellado",
"rol": "O-1234-2020",
"fecha": "23/11/2024",
"infraccion": "ESTAFA",
"estado": "Tramitación",
"etapa": "Investigación",
"litigantes": [
{
"nombre": "JUAN PEREZ SOTO",
"sujeto": "Querellado",
"situacionLibertad": "Libre"
}
],
"materia": "Querella",
"tribunal": "JUZGADO DE GARANTÍA FICTICIO",
"esDenunciado": true
}
],
"totalCoincidencias": 1
},
"noticias": {
"coincidencias": [],
"totalCoincidencias": 0
},
"pepChile": {
"coincidencias": [
{
"nombre": "JUAN PEREZ SOTO",
"cargo": "CONCEJAL",
"institucion": "MUNICIPALIDAD FICTICIA",
"periodo": "2018 - 2022"
}
],
"totalCoincidencias": 1,
"marshal": {
"detectado": true
}
},
"familiaresPep": {
"coincidencias": [
{
"nombre": "FAMILIAR FICTICIO",
"cargo": "SUBSECRETARIO",
"institucion": "MINISTERIO FICTICIO",
"url": "https://www.infoprobidad.cl/Declaracion/",
"periodo": "16-01-2025",
"datosRelaciones": [
{
"nombre": "JUAN PEREZ SOTO",
"parentesco": "hijo"
}
]
}
],
"totalCoincidencias": 1,
"marshal": {
"detectado": false
}
},
"funcionariosPublicos": {
"coincidencias": [
{
"nombre": "JUAN PEREZ SOTO",
"cargo": "CONCEJAL",
"institucion": "MUNICIPALIDAD FICTICIA",
"periodo": "2020"
}
],
"totalCoincidencias": 1
}
}
}
Campos dentro de data (persona natural):
| Campo | Tipo | Puede ser null | Descripción |
|---|---|---|---|
rut | string | No | RUT consultado (formato 12345678-9). |
estado | string | No | "PROCESADO" o "NO PROCESADO" (ver Sin búsqueda posible). |
tipoPersona | string | No | Siempre "natural". |
nombre | string | No | Nombre completo usado en la búsqueda; "" si no hay. |
riesgo | string | No | Riesgo agregado del perfil: "free", "medium" o "critical". |
sociedades | object | No | Sociedades en las que participa la persona (ver tabla siguiente). |
listasInternacionales | object | No | Coincidencias en listas internacionales y total. |
penal | object | No | Coincidencias de antecedentes penales y total. |
noticias | object | No | Coincidencias de noticias, incluidos los hallazgos de Marshal, y total. |
pepChile | object | No | Coincidencias de PEP en Chile, total y detección de Marshal (ver Marshal). |
familiaresPep | object | No | Coincidencias de familiares de PEP, total y detección de Marshal. |
funcionariosPublicos | object | No | Coincidencias de funcionarios públicos y total. |
sociedades.coincidencias[] (persona natural): un elemento por cada sociedad en la que participa la persona. totalCoincidencias es la cantidad de sociedades.
| Campo | Tipo | Puede ser null | Descripción |
|---|---|---|---|
nombreSociedad | string | Sí | Razón social de la sociedad en la que participa la persona. |
rutSociedad | string | Sí | RUT de esa sociedad. |
nombreSocio | string | Sí | Nombre de la persona consultada. |
rutSocio | string | Sí | RUT de la persona consultada. |
fecha | string | Sí | Fecha de constitución de la sociedad (formato YYYY-MM-DD). |
socios | array | No | Socios de la sociedad (ver Estructuras comunes). |
extractos | array | No | Extractos o publicaciones de la sociedad. |
participaciones | array | Sí | Sociedades en las que esa sociedad participa. |
fuente | string | Sí | Fuente de la relación entre la persona y la sociedad: "Diario Oficial", "Empresa en un Día", "SII", "CMF" o "MDH". |
Estructuras comunes
Estas estructuras son las mismas para personas naturales y jurídicas.
Cada bloque (sociedades, listasInternacionales, penal, noticias, pepChile, familiaresPep, funcionariosPublicos) tiene estos campos:
| Campo | Tipo | Descripción |
|---|---|---|
coincidencias | array | Registros encontrados. |
totalCoincidencias | number | Total de coincidencias encontradas. |
marshal | object | Solo en pepChile y familiaresPep. Resultado del análisis Marshal (ver Marshal). |
sociedades.coincidencias[].socios[]:
| Campo | Tipo | Descripción |
|---|---|---|
nombre | string | Nombre del socio. |
rut | string | RUT del socio. |
domicilio | string | Domicilio del socio. |
tipoDeParticipacion | string | Roles unidos con " - ": Socio, Administrador, Alta dirección, Socio Indirecto. |
cargo | string | Cargo dentro de la sociedad (si aplica). |
porcentajeParticipacion | string | Porcentaje de participación (ej: "70"). |
sociedades.coincidencias[].extractos[]:
| Campo | Tipo | Descripción |
|---|---|---|
actuacion | string | Tipo de actuación (ej: CONSTITUCION). |
fecha | string | Fecha de la actuación (formato YYYY-MM-DD). |
url | string | URL al documento del extracto, si está disponible. |
sociedades.coincidencias[].participaciones[]:
| Campo | Tipo | Descripción |
|---|---|---|
razonSocial | string | Razón social de la sociedad participada. |
nombre | string | Mismo valor que razonSocial. |
rut | string | RUT de la sociedad participada. |
tipoPersona | string | Siempre "juridica". |
tipoDeParticipacion | string | Rol en la sociedad participada. |
cargo | string | Cargo (si aplica). |
porcentajeParticipacion | string | Porcentaje de participación. |
domicilio | string | Domicilio declarado. |
vigente | boolean | true si la participación sigue vigente. |
listasInternacionales.coincidencias[]:
| Campo | Tipo | Descripción |
|---|---|---|
nombre | string | Nombre relacionado al registro en la lista. |
lista | string | Nombre de la lista. |
url | string | URL con el documento o referencia. |
penal.coincidencias[]:
| Campo | Tipo | Descripción |
|---|---|---|
nombre | string | Nombre del sujeto. |
postura | string | Postura en el proceso (ej: Querellante, Querellado). |
rol | string | Rol o número de causa. |
fecha | string | Fecha de la causa (formato DD/MM/YYYY). |
infraccion | string | Descripción de la infracción. |
estado | string | Estado procesal (ej: Tramitación). |
etapa | string | Etapa del proceso. |
litigantes | array | Litigantes con nombre, sujeto y situacionLibertad. |
materia | string | Materia del proceso. |
tribunal | string | Tribunal asociado. |
esDenunciado | boolean | Indica si el sujeto figura como denunciado. |
noticias.coincidencias[]:
| Campo | Tipo | Descripción |
|---|---|---|
nombre | string | Nombre buscado. |
titulo | string | Título de la noticia o del hallazgo. |
fuente | string | Medio o fuente de la noticia. |
url | string | URL de la noticia. |
urlFuente | string | URL del medio. |
tema | array | Temas o categorías de riesgo asociados. |
periodo | string | Fecha de publicación (formato DD-MM-YYYY). |
pepChile.coincidencias[] y funcionariosPublicos.coincidencias[]:
| Campo | Tipo | Descripción |
|---|---|---|
nombre | string | Nombre de la persona. |
cargo | string | Cargo o posición. |
institucion | string | Institución asociada. |
periodo | string | Periodo o fecha del cargo. |
familiaresPep.coincidencias[]:
| Campo | Tipo | Descripción |
|---|---|---|
nombre | string | Nombre del familiar PEP. |
cargo | string | Cargo o posición. |
institucion | string | Institución asociada. |
url | string | URL con información adicional. |
periodo | string | Periodo o fecha. |
datosRelaciones | array | Relaciones del familiar PEP, con nombre y parentesco. |
Formato de periodo: las fechas exactas se entregan como DD-MM-YYYY; los periodos que la fuente informa como año o rango (ej: "2020", "2018 - 2022") se entregan tal cual. Cuando la fuente no informa periodo, viaja null.
Nota: algunos campos pueden ser null o estar ausentes según la disponibilidad de datos en las fuentes consultadas.
Marshal
Cuando tu plan cuenta con Marshal y el RUT está marcado con Marshal en tu cuenta (al cargarlo con includeMarshal o al usar Actualizar Marshal), el reporte incorpora el resultado del último análisis Marshal completado:
noticias: los hallazgos de Marshal en medios de prensa aparecen al inicio decoincidencias, con la misma estructura que una noticia, y se suman atotalCoincidencias. Sutemaindica la categoría de riesgo del hallazgo.pepChile.marshal.detectado:truesi Marshal detectó que la persona consultada es PEP.familiaresPep.marshal.detectado:truesi Marshal detectó una relación con un PEP.
marshal.detectado se informa igual para personas naturales y jurídicas.
Valor de marshal.detectado | Significado |
|---|---|
true | Marshal detectó la condición. |
false | El análisis Marshal se completó y no detectó la condición. |
null | El RUT no tiene análisis Marshal completado (o no tiene Marshal). |
Para saber si el análisis ya terminó, revisa compliance.estadoMarshal en el Resumen de un perfil. Para solicitar un análisis nuevo de un RUT ya cargado, usa Actualizar Marshal.
Sin búsqueda posible
Si no hay un nombre o razón social con el cual buscar el RUT (o, en una persona natural, falta el apellido), el reporte viaja con estado: "NO PROCESADO" y sin coincidencias en las fuentes de compliance: listas de coincidencias vacías y totales en 0. Si el RUT tiene un análisis Marshal completado, noticias incluye igual sus hallazgos.
Para valores como postura, estado y riesgo, consulta el Glosario de la API v2. Los términos de Marshal están en el Glosario de la API v3.
Errores
Además de los errores comunes y los de acceso al RUT, este endpoint puede responder:
400 - RUT inválido
El RUT de la ruta no tiene un formato válido o su dígito verificador no corresponde. Revisa el formato y vuelve a enviar la solicitud.
{
"success": false,
"code": 400,
"error": "El RUT ingresado no es válido. Por favor verifica el formato."
}
400 - corporationId no permitido
La solicitud incluye corporationId, un parámetro que este endpoint no acepta. Quítalo y vuelve a enviar la solicitud.
{
"success": false,
"code": 400,
"error": "No se permite enviar corporationId en la petición."
}
401 - No autorizado
El token no se envió, expiró o no es válido (ver Errores de autenticación). Si expiró, solicita uno nuevo en Obtener Token.
{
"success": false,
"code": 401,
"error": "El token de autenticación no es válido."
}
403 - RUT sin acceso
El RUT existe en Sheriff, pero no está cargado en tu cuenta. Cárgalo con Carga de RUT antes de consultarlo.
{
"success": false,
"code": 403,
"error": "No tienes permisos para consultar este RUT."
}
403 - Plan sin el ayudante Compliance
Tu plan no incluye el ayudante Compliance.
{
"success": false,
"code": 403,
"error": "El plan no cuenta con el ayudante de compliance."
}
404 - RUT no encontrado
El RUT no existe en Sheriff. Cárgalo con Carga de RUT antes de consultarlo.
{
"success": false,
"code": 404,
"error": "El RUT consultado no existe en el sistema."
}
429 - Demasiadas solicitudes
Superaste el límite de solicitudes (ver Rate Limits). Espera los segundos que indica el header Retry-After antes de reintentar.
{
"success": false,
"code": 429,
"error": "Demasiadas solicitudes desde esta API externa, intente más tarde."
}
500 - Error interno del servidor
Ocurrió un error inesperado. Intenta nuevamente más tarde.
{
"success": false,
"code": 500,
"error": "Ocurrió un error interno. Intenta nuevamente más tarde."
}